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CHAPTER  1 


INTRODUCTION 


The  Ada  implementation  described  above  was  tested  according  to  the  Ada 
Validation  Procedures  [Pro90]  against  the  Ada  Standard  (Ada831  using  the 
current  Ada  Compiler  Validation  Capability  (ACVC).  This  Validation  Summary 
Report  (VSR)  gives  an  account  of  the  testing  of  this  Ada  implementation. 

For  any  technical  terms  used  in  this  report,  the  reader  is  referred  to 
[Pro90].  A  detailed  description  of  the  ACVC  may  be  found  in  the  current 
ACVC  User's  Guide  [UG89J. 


1.1  USE  OF  THIS  VALIDATION  SUMMARY  REPORT 

Consistent  with  the  national  laws  of  the  originating  country,  the  Ada 
Certification  Body  may  make  full  and  free  public  disclosure  of  this  report. 
In  the  United  States,  this  is  provided  in  accordance  with  the  "Freedom  of 
Information  Act"  (5  U.S.C.  #552).  The  results  of  this  validation  apply 
only  to  the  computers,  operating  systems,  and  compiler  versions  identified 
in  this  report. 

The  organizations  represented  on  the  signature  page  of  this  report  do  not 
represent  or  warrant  that  all  statements  set  forth  in  this  report  are 
accurate  and  complete,  or  that  the  subject  implementation  has  no 
nonconformities  to  the  Ada  Standard  other  than  those  presented.  Copies  of 
this  report  are  available  to  the  public  from  the  AVF  which  performed  this 
validation  or  from: 

National  Technical  Information  Service 
5285  Port  Royal  Road 
Springfield  VA  22161 

Questions  regarding  this  report  or  the  validation  test  results  should  be 
directed  to  the  AVF  which  performed  this  validation  or  to: 

Ada  Validation  Organization 

Computer  &  Software  Engineering  Division 

Institute  for  Defense  Analyses 

1801  North  Beauregard  Street 

Alexandria  VA  22311-1772 
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1 . 2  REFERENCES 

[Ada83]  Reference  Manual  for  the  Ada  Programming  Language, 

ANSI/MIL-STD-1815A,  February  1983  and  ISO  8652-1987. 

[Pro90]  Ada  Compiler  Validation  Procedures,  Version  2.1,  Ada  Joint  Program 
Office,  August  1990. 

[UG89]  Ada  Compiler  Validation  Capability  User's  Guide,  21  June  1989. 


1.3  ACVC  TEST  CLASSES 

Compliance  of  Ada  implementations  is  tested  by  means  of  the  ACVC.  The  ACVC 
contains  a  collection  of  test  programs  structured  into  six  test  classes: 

A,  B,  C,  D,  E,  and  L.  The  first  letter  of  a  test  name  identifies  the  class 
to  which  it  belongs.  Class  A,  C,  D,  and  E  tests  are  executable.  Class  B 
and  class  L  tests  are  expected  to  produce  errors  at  compile  time  and  link 
time,  respectively. 

The  executable  tests  are  written  in  a  self-checking  manner  and  produce  a 
PASSED,  FAILED,  or  NOT  APPLICABLE  message  indicating  the  result  when  they 
are  executed.  Three  Ada  library  units,  the  packages  REPORT  and  SPPRT13, 
and  the  procedure  CHECK  FILE  are  used  for  this  purpose.  The  package  REPORT 
also  provides  a  set  of  Identity  functions  used  to  defeat  some  compiler 
optimizations  allowed  by  the  Ada  Standard  that  would  circumvent  a  test 
objective.  The  package  SPPRT13  is  used  by  many  tests  for  Chapter  13  of  the 
Ada  Standard.  The  procedure  CHECK_FILE  is  used  to  check  the  contents  of 
text  files  written  by  some  of  the  Class  C  tests  for  Chapter  14  of  the  Ada 
Standard.  The  operation  of  REPORT  and  CHECK_FILE  is  checked  by  a  set  of 
executable  tests.  If  these  units  are  not  operating  correctly,  validation 
testing  is  discontinued. 

Class  B  tests  check  that  a  compiler  detects  illegal  language  usage.  Class 
B  tests  are  not  executable.  Each  test  in  this  class  is  compiled  and  the 
resulting  compilation  listing  is  examined  to  verify  that  all  violations  of 
the  Ada  Standard  are  detected.  Some  of  the  class  B  tests  contain  legal  Ada 
code  which  must  not  be  flagged  illegal  by  the  compiler.  This  behavior  is 
also  verified. 

Class  L  tests  check  that  an  Ada  implementation  correctly  detects  violation 
of  the  Ada  Standard  involving  multiple,  separately  compiled  units.  Errors 
are  expected  at  link  time,  and  execution  is  attempted. 

In  some  tests  of  the  ACVC,  certain  macro  strings  have  to  be  replaced  by 
implementation-specific  values  —  for  example,  the  largest  integer.  A  list 
of  the  values  used  for  this  implementation  is  provided  in  Appendix  A.  In 
addition  to  these  anticipated  test  modifications,  additional  changes  may  be 
required  to  remove  unforeseen  conflicts  between  the  tests  and 
implementation-dependent  characteristics.  The  modifications  required  for 
this  implementation  are  described  in  section  2.3. 
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For  each  Ada  implementation,  a  customized  test  suite  is  produced  by  the 
AVF.  This  customization  consists  of  making  the  modifications  described  in 
the  preceding  paragraph,  removing  withdravm  tests  (see  section  2.1)  and, 
possibly  some  inapplicable  tests  (see  section  2.2  and  [UG89]). 

In  order  to  pass  an  ACVC  an  Ada  implementation  must  process  each  test  of 
the  customized  test  suite  according  to  the  Ada  Standard. 


1.4  DEFINITION  OF  TERMS 


Ada  Compiler  The  software  and  any  needed  hardware  that  have  to  be  added 
to  a  given  host  and  target  computer  system  to  allow 
transformation  of  Ada  programs  into  executable  form  and 
execution  thereof. 

Ada  Compiler  The  means  for  testing  compliance  of  Ada  implementations. 
Validation  consisting  of  the  test  suite,  the  support  programs,  the  ACVC 

Capability  user's  guide  and  the  template  for  the  validation  summary 

(ACVC)  report. 

Ada  An  Ada  compiler  with  its  host  computer  system  and  its 

Implementation  target  computer  system. 

Ada  Joint  The  part  of  the  certification  body  which  provides  policy  and 

Program  guidance  for  the  Ada  certification  system. 

Office  (AJPO) 

Ada  The  part  of  the  certification  body  which  carries  out  the 

Validation  procedures  required  to  establish  the  compliance  of  an  Ada 
Facility  (AVF)  implementation. 

Ada  The  part  of  the  certification  body  that  provides  technical 

Validation  guidance  for  operations  of  the  Ada  certification  system. 

Organization 
(AVO) 

Compliance  of  The  ability  of  the  implementation  to  pass  an  ACVC  version, 
an  Ada 

Implementation 

Computer  A  functional  unit,  consisting  of  one  or  more  computers  and 

System  associated  software,  that  uses  common  storage  for  all  or 

part  of  a  program  and  also  for  all  or  part  of  the  data 
necessary  for  the  execution  of  the  program;  executes 
user-written  or  user-designated  programs;  performs 
user-designated  data  manipulation,  including  arithmetic 
operations  and  logic  operations;  and  that  can  execute 
programs  that  modify  themselves  during  execution.  A 
computer  system  may  be  a  stand-alone  unit  or  may  consist  of 
several  inter-connected  units. 
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Conformity 


Customer 


Declaration  of 
Conformance 


Host  Computer 
System 

Inapplicable 

test 

ISO 

LRM 


Operating 

System 


Target 

Computer 

System 

Validated  Ada 
Compiler 

Validated  Ada 
Implementation 

Validation 


Vithdravn 

test 


Fulfillment  by  a  product,  process,  or  service  of  all 
requirements  specified. 

An  individual  or  corporate  entity  who  enters  into  an 
agreement  with  an  AVF  which  specifies  the  terms  and 
conditions  for  AVF  services  (of  any  kind)  to  be  performed. 

A  formal  statement  from  a  customer  assuring  that  conformity 
is  realized  or  attainable  on  the  Ada  implementation  for 
which  validation  status  is  realized. 

A  computer  system  where  Ada  source  programs  are  transformed 
into  executable  form. 

A  test  that  contains  one  or  more  test  objectives  found  to  be 
irrelevant  for  the  given  Ada  implementation. 

International  Organization  for  Standardization. 

The  Ada  standard,  or  Language  Reference  Manual,  published  as 
ANSI/MIL-STD-1815A-1983  and  ISO  8652-1987.  Citations  from 
the  LRM  take  the  form  "<section>.<subsection>:<paragraph>. " 

Software  that  controls  the  execution  of  programs  and  that 
provides  services  such  as  resource  allocation,  scheduling, 
input/output  control,  and  data  management.  Usually, 
operating  systems  are  predominantly  software,  but  partial  or 
complete  hardware  implementations  are  possible. 

A  computer  system  where  the  executable  form  of  Ada  programs 
are  executed. 


The  compiler  of  a  validated  Ada  implementation. 


An  Ada  implementation  that  has  been  validated  successfully 
either  by  AVF  testing  or  by  registration  [Pro90]. 

The  process  of  checking  the  conformicy  of  an  Ada  compiler  to 
the  Ada  programming  language  and  of  issuing  a  certificate 
for  this  ij;plementation. 

A  test  found  to  be  incorrect  and  not  used  in  conformity 
testing.  A  test  may  be  incorrect  because  it  has  an  invalid 
test  objective,  fails  to  meet  its  test  objective,  or 
contains  erroneous  or  illegal  use  of  the  Ada  programming 
language . 
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IMPLEMENTATION  DEPENDENCIES 


2 . 1  WITHDRAWN  TESTS 

The  following  tests  have  been  withdrawn  by  the  AVO.  The  rationale  for 
withdrawing  each  test  is  available  from  either  the  AVO  or  the  AVF.  The 
publication  date  for  this  list  of  withdrawn  tests  is  14  March  1991. 


E28005C 

B28006C 

C34006D 

C35702A 

C35702B 

C35508I 

C35508J 

C35508M 

C35508N 

B41308B 

C43004A 

C45114A 

C45346A 

C45612A 

C45612B 

C45612C 

C45651A 

C46022A 

B49008A 

A74006A 

C74308A 

B83022B 

B83022H 

B83025B 

B83025D 

C83026A 

B83026B 

C83041A 

B85001L 

C86001F 

C94021A 

C97116A 

C98003B 

BA2011A 

CB7001A 

CB7001B 

CB7004A 

CC1223A 

BC1226A 

CC1226B 

BC3009B 

BD1B02B 

B01B06A 

AD1B08A 

BD2A02A 

C02A21E 

CD2A23E 

CD2A32A 

C02A41A 

CD2A41E 

C02A87A 

CD2B15C 

BD3006A 

BD4008A 

CD4022A 

CD4022D 

CD4024B 

CD4024C 

CD4024D 

CD4031A 

CD4051D 

CD5111A 

CD7004C 

ED7005D 

CD7005E 

AD7006A 

CD7006E 

AD7201A 

AD7201E 

CD7204B 

AD7206A 

BD8002A 

BD8004C 

CD9005A 

CD9005B 

CDA201E 

CE2107I 

CE2117A 

CE2117B 

CE2119B 

CE2205B 

CE2405A 

CE3111C 

CE3116A 

CE3118A 

CE3411B 

CE3412B 

CE3607B 

CE3607C 

CE3607D 

CE3812A 

CE3814A 

CE3902B 

2 . 2  INAPPLICABLE  TESTS 

A  test  is  inapplicable  if  it  contains  t^st  objectives  which  are  irrelevant 
for  a  given  Ada  implementation.  Reasons  for  a  test's  inapplicability  may 
be  supported  by  documents  issued  by  the  ISO  and  the  AJPO  known  as  Ada 
Commentaries  and  commonly  referenced  in  the  format  Al-ddddd.  For  this 
implementation,  the  following  tests  were  determined  to  be  inapplicable  for 
the  reasons  indicated;  references  to  Ada  Commentaries  are  included  as 
appropriate. 
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The  following  201  tests  have  floating-point  type  declarations  requiring 
more  digits  than  SYSTEM. MAXDIGITS: 


C24113L..Y  (14  tests) 
C35706L..Y  (14  tests) 
C35708L..Y  (14  tests) 
C45241L. .Y  (14  tests) 
C45421L..Y  (14  tests) 
C45524L..Z  (15  tests) 
C45641L..Y  (14  tests) 


C35705L..Y  (14 
C35707L..Y  (14 
C35802L..Z  (15 
C45321L. .Y  (14 
C45521L..Z  (15 
C45621L..Z  (15 
C46012L..Z  (15 


tests) 

tests) 

tests) 

tests) 

tests) 

tests) 

tests) 


The  following  20  tests  check  for  the  predefined  type  LONG_INTEGER ;  for 
this  implementation,  there  is  no  such  type: 


C35404C 

C45231C 

C45304C 

C45411C 

C45412C 

C45502C 

C45503C 

C45504C 

C45504F 

C45611C 

C45613C 

C45614C 

C45631C 

C45632C 

B52004D 

C55B07A 

B55B09C 

B86001W 

C86006C 

CD7101F 

C35713B,  C45423B,  B86001T,  and  C86006H  check  for  the  predefined  type 
SH0RT_FL0AT;  for  this  implementation,  there  is  no  such  type. 

C35713C,  B86001U,  and  C86006G  check  for  the  predefined  type  LONGFLOAT; 
for  this  implementation,  there  is  ;io  such  type. 

C35713D  and  B86001Z  check  for  a  predefined  floating-point  type  with  a 
name  other  than  FLOAT,  L0NG_FL0AT,  or  SH0RT_FL0AT;  for  this 
implementation,  there  is  no  such  type. 

C45423A,  C45523A,  and  C45622A  check  that  the  proper  exception  is  raised 
if  MACHINE_0VERFL0v/S  is  TRUE  and  the  results  of  various  floating-point 
operations  lie  outside  the  range  of  the  base  type;  for  this 
implementation,  MACHINE_0VERFL0WS  is  FALSE. 

C45531M..P  and  C45532M..P  (8  tests)  check  fixed-point  operations  for 
types  that  require  a  SYSTEM. MAXMANT I SSA  of  47  or  greater;  for  this 
implementation,  MAX_MANTISSA  is  less  than  47. 

C45536A,  C46013B,  C46031B,  C46033B,  and  C46034B  contain  length  clauses 
that  specify  values  for  'SMALL  that  are  not  powers  of  two  or  ten;  this 
implementation  does  not  support  such  values  for  'SMALL. 

B86001Y  uses  the  name  of  a  predefined  fixed-point  type  other  than  type 
DURATION;  for  this  implementation,  there  is  no  such  type. 

CD1009C  checks  whether  a  length  clause  can  specify  a  non-default  size 
for  a  floating-point  type;  this  implementation  does  not  support  such 
sizes. 


CD2A53A  checks  operations  of  a  fixed-point  type  for  which  a  length 
clause  specifies  a  power-of-ten  TYPE' SMALL;  this  implementation  does  not 
support  decimal  'SMALLs.  (See  section  2.3.) 
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CD2A84A,  CD2A84E,  CD2A84I..J  (2  tests),  and  CD2A840  use  length  clauses 
to  specify  non-default  sizes  for  access  types;  this  implementation  does 
not  support  such  sizes. 

BD8001A,  BD8003A,  BD8004A..B  (2  tests),  and  AD8011A  use  machine  code 
insertions;  this  implementation  provides  no  package  MACHINE_CODE . 

AE2101C  and  EE2201D..E  (2  tests)  use  instantiations  of  package 
SEQUENTIAL_IO  with  unconstrained  array  types  and  record  types  with 
discriminants  without  defaults;  these  instantiations  are  rejected  by 
this  compiler. 

AE2101H,  EE2401D,  and  EE2401G  use  instantiations  of  package  DIRECT_IO 
with  unconstrained  array  types  and  record  types  with  discriminants 
without  defaults;  these  instantiations  are  rejected  by  this  compiler. 

The  tests  listed  in  the  following  table  check  that  USE_ERROR  is  raised 
if  the  given  file  operations  are  not  supported  for  the  given  combination 
of  mode  and  access  method;  this  implementation  supports  these 
operations. 


Test 

File  Operation  Mode 

File  Access 

Method 

CE2102D 

CREATE 

IN  FILE 

SEQUENTIAL 

10 

CE2102E 

CREATE 

OUT  FILE 

SEQUENTIAL 

10 

CE2102F 

CREATE 

INOUT  FILE 

DIRECT  10 

CE2102I 

CREATE 

IN  FILE 

DIRECT'IO 

CE2102J 

CREATE 

OUT  FILE 

DIRECT“I0 

CE2102N 

OPEN 

IN  FILE 

SEQUENTIAL 

10 

CE21020 

RESET 

IN”FILE 

SEQUENTIAL 

10 

CE2102P 

OPEN 

OUT  FILE 

SEQUENTIAL  10 

CE2102Q 

RESET 

OUT  FILE 

SEQUENTIAL 

10 

CE2102R 

OPEN 

INOUT  FILE 

DIRECT  10 

CE2102S 

RESET 

INOUT  FILE 

DIRECT  10 

CE2102T 

OPEN 

IN  FILE 

DIRECT  10 

CE2102U 

RESET 

IN  FILE 

DIRECT  10 

CE2102V 

OPEN 

OUT  FILE 

DIRECT  10 

CE2102W 

RESET 

OUT  FILE 

DIRECT  10 

CE3102E 

CREATE 

IN  FILE 

TEXT  10 

CE3102F 

RESET 

Any  Node 

TEXT  10 

CE3102G 

DELETE 

TEXT  10 

CE3102I 

CREATE 

OUT  FILE 

TEXT  10 

CE3102J 

OPEN 

IN  FILE 

TEXT  10 

CE3102K 

OPEN 

OUT  FILE 

TEXT  10 

CE2203A  checks  that  WRITE  raises  USE_ERROR  if  the  capacity  of  an 
external  sequential  file  is  exceeded;  this  implementation  cannot 
restrict  file  capacity. 

CE2403A  checks  that  WRITE  raises  USE_ERROR  if  the  capacity  of  an 
external  direct  file  is  exceeded;  this  implementation  cannot  restrict 
file  capacity. 
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CE3304A  checks  that  SET_LINE_LENGTH  and  SET_PAGE_LENGTH  raise  USE_ERROR 
if  they  specify  an  inappropriate  value  for  the  external  file;  there  are 
no  inappropriate  values  for  this  implementation. 

CE3413B  checks  that  PAGE  raises  LAYOUT_ERROR  when  the  value  of  the  page 
number  exceeds  COUNT'LAST;  for  this  implementation,  the  value  of 
COUNT' LAST  is  greater  than  150000,  making  the  checking  of  this  objective 
impractical. 


2.3  TEST  MODIFICATIONS 

Modifications  (see  section  1.3)  were  required  for  36  tests  and  2  support 
packages . 

The  following  tests  were  split  into  two  or  more  tests  because  this 
implementation  did  not  report  the  violations  of  the  Ada  Standard  in  the  way 
expected  by  the  original  tests. 

B24009A  B59001E  B59001F  B83033B 


CD2A53A  was  graded  inapplicable  by  Evaluation  Modification  as  directed  by 
the  AVO.  The  test  contains  a  specification  of  a  power-of-10  value  as 
'SMALL  for  a  fixed-point  type.  The  AVO  ruled  that,  under  ACVC  1.11, 
support  of  decimal  'SMALLs  may  be  omitted. 


The  tests  below  were  graded  passed  by  Test  Modification  as  directed  by  the 
AVO.  These  tests  all  use  one  of  the  generic  support  procedures, 
Length_Check  or  Enum_Check  (in  support  files  LENCHECK.ADA  &  ENUMCHEK.ADA) , 
which  use  the  generic  procedure  Unchecked_Conversion.  This  implementation 
rejects  instantiations  of  Unchecked_Conversion  with  array  types  that  have 
non-static  index  ranges.  The  AVO  ruled  that  since  this  issue  was  not 
addressed  by  AT-00590,  which  addresses  required  support  for 
Unchecked_Conversion,  and  since  AI-00590  is  considered  not  binding  under 
ACVC  1.11,  the  support  procedures  could  be  modified  to  remove  the  use  of 
Unchecked_Conversion.  Lines  40.. 43,  50,  and  56.. 58  in  LENCHECK  and  lines 
42,  43,  and  58.. 63  in  ENUMCHEK  were  commented  out. 

CD1009A  CD1009I  CD1009M  CD1009V  CD1009W  CD1C03A 

CD1C04D  CD2A21A..C  CD2A22J  CD2A23A..B  CD2A24A  CD2A31A..C 

CD2A81A  CD3014C  CD3014F  CD3015C  CD3015E..F  CD3015H 

CD3015K  CD3022A  CD4061A 

LA3004A  and  LA3004B  were  graded  passed  by  Processing  and  Evaluation 
Modification  as  directed  by  the  AVO.  These  tests  check  that  when  the 
bodies  of  library  units  (a  procedure,  function,  and  package)  are  made 
obsolete,  that  the  implementation  will  detect  the  missing  bodies  at  link 
time.  This  implementation  will  detect  the  missing  bodies  at  link  time. 
This  implementation  detects  the  missing  bodies,  but  it  also  issues  error 
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messages  that  indicate  that  the  main  procedures  must  be  re-compiled;  this 
behavior  violates  LRM  10.3:6  &  8.  To  confirm  that  the  implementation  does 
not  in  fact  require  recompilation  of  the  main  procedures,  the  obsolete 
bodies  were  re-compiled  (files  LA3004A2..4  and  LA3004B2..4  were  modified  to 
contain  only  the  bodies)  and  the  tests  were  then  linked  and  executed; 

Report .Result  output  "NOT  APPLICABLE"  as  expected. 

C34009D  and  C34009J  were  graded  passed  by  Evaluation  Modification  as 
directed  by  the  AVO.  These  tests  check  that  'SIZE  for  a  composite  type  is 
greater  than  or  equal  to  the  sum  of  its  components'  'SIZE  values;  but  this 
issue  is  addressed  by  AI-00825,  which  has  not  been  considered;  there  is  not 
an  obvious  interpretation.  This  implementation  represents  array  components 
whose  length  depends  on  a  discriminant  with  a  default  value  by  implicit 
pointers  into  the  heap  space;  thus,  the  'SIZE  of  such  a  record  type  might 
be  less  than  the  sum  of  its  components  'SIZEs,  since  the  size  of  the  heap 
space  that  is  used  by  the  varying-length  array  components  is  not  counted  as 
part  of  the  'SIZE  of  the  record  type.  These  tests  were  graded  passed  given 
that  the  Report .Result  output  was  "FAILED"  and  the  only  Report .Failed 
output  was  "INCORRECT  'BASE' SIZE",  from  line  195  of  C34009D  and  line  193  in 
C34009J. 
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PROCESSING  INFORMATION 


3.1  TESTING  ENVIRONMENT 

The  Ada  implementation  tested  in  this  validation  effort  is  described 
adequately  by  the  information  given  in  the  initial  pages  of  this  report. 

For  technical  and  sales  information  about  this  Ada  implementation,  contact: 

Joe  Kohli 

Irvine  Compiler  Corporation 
34  Executive  Park,  Suite  270 
Irvine,  California  92714 


Testing  of  this  Ada  implementation  was  conducted  at  the  customer's  site  by 
a  validation  team  from  the  AVF. 


3.2  SUMMARY  OF  TEST  RESULTS 

An  Ada  Implementation  passes  a  given  ACVC  version  if  it  processes  each  test 
of  the  customized  test  suite  in  accordance  with  the  Ada  Programming 
Language  Standard,  whether  the  test  is  applicable  or  inapplicable; 
otherwise,  the  Ada  Implementation  fails  the  ACVC  [Pro90]. 
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For  all  processed  tests  ( inappliceible  and  applicable),  a  result  was 
obtained  that  conforms  to  the  Ada  Programming  Language  Standard. 


a)  Total  Number  of  Applicable  Tests  3787 

b)  Total  Number  of  Withdrawn  Itests  93 

c)  Processed  Inapplicable  Tests  89 

d)  Non-Processed  I/O  Tests  0 

e)  Non-Processed  Floating-Point 

Precision  Tests  201 

f)  Total  Number  of  Inapplicable  Tests  290 


g)  Total  Number  of  Tests  for  ACVC  1.11  4170 


All  I/O  tests  of  the  test  suite  were  processed  because  this  inplementation 
supports  a  file  system.  The  above  number  of  floating-point  tests  were  not 
processed  because  they  used  floating-point  precision  exceeding  that 
supported  by  the  inplementation.  When  this  conqpiler  was  test^,  the  tests 
listed  in  section  2.1  had  been  withdrawn  because  of  test  errors. 


3.3  TEST  EXECUTION 

A  magnetic  tape  containing  the  customized  test  suite  (see  section  1.3)  was 
taken  on-site  by  the  vali^tion  team  for  processing.  The  contents  of  the 
magnetic  tape  were  loaded  onto  the  host  cranputer  using  NFS  from  a  remote 
host  with  a  directly  connected  9-track  tape  drive.  The  communication 
network  was  Ethernet. 


After  the  test  files  were  loaded  onto  the  host  conpjter,  the  full  set  of 
tests  was  processed  by  the  Ada  in^lementation. 


The  tests  were  con^jiled  and  linked  on  the  host  computer  system,  as 
appropriate.  Hie  executable  images  resided  on  the  host/target  computer 
system  and  were  run.  The  results  were  captured  on  the  host  computer 
system. 


3-2 


PROCESSING  INFORMATION 


Testing  was  performed  using  command  scripts  provided  by  the  customer  and 
reviewed  by  the  validation  team.  See  Appendix  B  for  a  complete  listing  of 
the  processing  options  for  this  implementation.  It  also  indicates  the 
default  options.  The  options  invoked  explicitly  for  validation  testing 
during  this  test  were: 

Option  I  Switch  Effect 


-stack_check 

-numeric_check 

-elaboration_check 

-noinfo 

-quiet 

-link=<main  program> 
-listing 

-maximum  error=0 


-nopreprocess 

-nowarnings 


Enable  stack  overflow  checking 
Enable  arithmetic  overflow  checks 
Enable  elaboration  checking 
Suppress  informationals 
Suppress  compiler  banners 
Link  the  provided  subprogram 
Generate  a  compilation  listing 
Set  maximum  number  of  errors  before  abort 
(A  value  of  zero  specifies  that  there  is  no 
maximum  error  limit.) 

Disable  compilation  of  preprocessor  directives 
Suppress  warnings 


Test  output,  compiler  and  linker  listings,  and  job  logs  were  captured  on 
magnetic  tape  and  archived  at  the  AVF.  The  listings  examined  on-site  by 
the  validation  team  were  also  archived. 
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MACRO  PARAMETERS 


This  appendix  contains  the  macro  parameters  used  for  customizing  the  ACVC. 
The  meaning  and  purpose  of  these  parameters  are  explained  in  [UG89].  The 
parameter  values  are  presented  in  two  tables.  The  first  table  lists  the 
values  that  are  defined  in  terms  of  the  maximum  input-line  length,  which  is 
the  value  for  $MAX_IN_LEN — also  listed  here.  These  values  are  expressed 
here  as  Ada  string  aggregates,  where  "V"  represents  the  maximum  input-line 
length. 

Macro  Parameter  Macro  Value 


$MAX_IN_LEN  254 

$BIG_ID1  (1..V-1  =>  'A',  V  *>  '1') 

$BIG_ID2  (1..V-1  =>  'A',  V  =>  '2') 

$BIG_ID3  (1..V/2  =>  'A')  &  '3'  & 

(1..V-1-V/2  =>  'A') 

$BIG_ID4  (1..V/2  =>  'A')  &  '4'  & 

(1..V-1-V/2  =>  'A') 

$BIG_INT_LIT  (1..V-3  =>  '0')  &  "298" 

$BIG_REAL_LIT  (1..V-5  =>  '0')  &  "690.0" 

$BIG_STRING1  &  (1..V/2  =>  'A')  & 

$BIG_STRING2  &  (1..V-1-V/2  =>  'A')  &  '1'  & 

SBLANKS  (1..V-20  =>  '  ' ) 

$MAX_LEN_INT_BASED_LITERAL 

"2;"  &  (1..V-5  =>  '0')  &  "11:" 

$MAX_LEN_REAL  BASED_LITERAL 

"16:"  &  (1..V-7  =>  '0')  &  "F.E:" 
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$MAX_STRING_LITERAL  &  (1..V-2  =>  'A')  & 

The  following  table  lists  all  of  the  other  macro  parameters  and  their 
respective  values. 

Macro  Parameter  Macro  Value 


$ACC_SIZE 

$ALIGNMENT 

$COUNT_LAST 

$DEFAULT_MEM_SIZE 

$DEFAULT_STOR_UNIT 

$DEFAULT_SYS_NAME 

$DELTA_DOC 

$ENTRY_ADDRESS 

$ENTRY_ADDRESS1 

$ENTRY_ADDRESS2 

$FIELD_UST 

$FILE_TERMINATOR 

$FIXED_NAME 

$FLOAT_NAME 

$FORM_STRING 

$F0RM_STRING2 

SGREATER  THAN  DURATION 


96 

4 

2147483647 

16777216 

8 

M68000 

0.000_000_000_465_661_287_307_739_257_812_5 

ad d r e s s_o f _en t r y 1 

address_of_entry2 

address_of _en  t  ry 3 

2147483647 

t  t 

NO_SUCH_FIXED_TYPE 

NO_SUCH_FLOAT_NAME 

II  It 

"CANNOT  RESTRICT  FILE  CAPACITY" 


524287.5 

$GREATER_THAN_DURATION_BASE_LAST 

10000000.0 

$GREATER_THAN_FLOAT_BASE_LAST 

1 . 123558209288946943370739E+307 

$GREATER_THAN_FLOAT_SAFE  LARGE 

1 .T23558209288946943370739E+307 
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$GREATER_THAN_SHORT_FLOAT_SAFE_LARGE 

1.0E308 

$HIGH_PRIORITY  255 

$ILLEGAL_EXTERNAL_FILE_NAME1 

/NODIRECTORY / FI LENAME 

$ILLEGAL_EXTERNAL_FILE_NAME2 

/NODIRECTORY/THIS-FILE-NAME-IS-ILLEGAL 

$INAPPROPRIATE_LINE_LENGTH 


-1 

$INAPPROPRIATE_PAGE_ 

LENGTH 

-1 

$INCLUDE_PRAGMA1 

PRAGMA  INCLUDE 

("a28006dl.tst") 

$INCLUDE_PRAGMA2 

PRAGMA  INCLUDE 

(''b28006fl.tst") 

$INTEGER_FIRST 

-2147483648 

$INTEGER_LAST 

2147483647 

$INTEGER_LAST_PLUS_1 

2147483648 

$INTERFACE_LANGUAGE 

C 

$LESS_THAN_DURATION 

-524287.5 

$LESS_THAN_DURATION_ 

BASE  FIRST 
-10000000.0 

$LINE_TERMINATOR 

ASCII. LF 

$LOW_PRIORITY 

0 

SMACHINE  CODE  STATEMENT 

NULL; 

$MACHINE_CODE_TYPE 

NO_SUCH_TYPE 

$MANTISSA_DOC 

31 

$MAX_DIGITS 

15 

$MAX_INT 

2147483647 

$MAX_INT_PLUS_1 

2147483648 

$MIN  INT 

-2147483648 
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$NAME 

$NAME_LIST 

$NAME_SPECIFICATIONl 

$NAME_SPECIFICATION2 

$NAME_SPECIFICATION3 

$NEG_BASED_INT 

$NEW_MEM_SIZE 

$NEW_STOR_UNIT 

$NEU_SYS_NAME 

$PAGE_TERMINATOR 

$RECORD_DEFINITION 

$RECORD_NAME 

$TASK_SIZE 

$TASK_STORAGE_SIZE 

$TICK 

$VARIABLE_ADDRESS 

$VARIABLE_ADDRESS1 

$VARIABLE_ADDRESS2 

$YOUR_PRAGMA 


TINY_INTEGER 

M68000 

./X2120A 

./X2102B 

./X3119A 

16#FFFFFFFE# 

16777216 

8 

M68000 
ASCII. FF 
NEW  INTEGER; 

N0_SUCH_MACHINE_C0DE_TYPE 

32 

16383 

(1.0/60.0) 
address_of_varl 
address_of_var2 
address_of_var3 
EXPORT  OBJECT 
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COMPILATION  SYSTEM  AND  LINKER  OPTIONS 


The  compiler  and  linker  options  of  this  Ada  implementation,  as  described  in 
this  Appendix,  are  provided  by  the  customer.  Unless  specifically  noted 
otherwise,  references  in  this  appendix  are  to  compiler  and  linker 
documentation  and  not  to  this  report. 
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Passiva  ICC  Oualifiart 
-arguaants  'args 
'display 
-halp 

-haipall  -all 
-hida 

-Ignora  cfg  -icfg 
-ignora~anv  -ianv 
-nonaal” 

-quiat 

-ssva_pas2 

-aava  temps  -save 

-succeM 

-symbols  -syns 

-temp 

-tinp><arg> 

-unique 

-verbose 


Display  all  arguments  to  the  ICC  command 

Display  all  actions  as  they  are  performed 

List  commonly  used  qualifiers 

List  all  available  quali^ers 

Suppress  naming  ICC  siAprocaasea  (VMS  only) 

Ignora  configuration  file  qualifiers 

Ignora  environment  variable  qualifiers 

Compile  with  'normal'  messagea 

Compile  quietly 

Sava  all  intermediate  files 

Save  temporary  files  generated  by  pes2 

Always  return  the  success  status 

Show  current  value  of  ICC  command's  symbols 

Use  temporary  directory  for  intermediate  files 

Use  <arg>  as  the  temporary  directory 

Use  unique  file  names  for  intermediate  files 

Compile  with  verbose  messages 


Active  ICC  Qualifiers 

-asm  Stop  at  the  generated  asseably  file 

-asm  flag  -asmf«<arg>  Explicitly  add  flag(s)  for  the  assembler 

-asm'name  -asmn«<arg>  Use  <arg>  as  the  assembler 

-c  ~  Stop  at  the  generated  C  source  file 

-cc  flag  -ccf«<arg>  Explicitly  add  flag(s)  for  the  C  compiler 

-cc^name  -ccnB<arg>  Use  <arg>  as  the  C  compiler 

-coptimize  Invoke  the  C  optimizer 

-exe  Link  a  non-Ada  program 

-execute  Execute  and  delete  executable  after  linking 

-execute  flag  -execf«<arg>  Explicitly  add  flagfs)  for  the  executable 

-ada  ext«<arg>  Set  Ada  file  extension 

-asm~ext«<arg>  Set  assembly  file  extension 

-c  ext«<arg>  Set  C  file  extension 

-exe  ext«<arg>  Set  executable  file  extension 

-int~exta<arg>  Set  IFORM  file  extension 

-lib“ext»<arg>  Set  object  archive/ library  file  extension 

-iiirp~ext«<arg>  Set  list  merge  file  extension 

-obj~ext«<arg>  Set  object  file  extension 

-opt~exta<arg>  Set  optimized  IFQSM  file  extension 

-pas_exta<arg>  Set  Pascel  file  extension 

-int  Stop  at  the  generated  iform  file 

-k^_teflpss<arg>  Save  filc<s)  with  extension(s)  in  <arg> 

-library  -lib«<arg>  Set  the  compilation  library  directory 

-loader_name  -loadera<arg>  Use  <arg>  as  the  loader 

-loader  oref lag  • loadpref «<arg> 

Explicitly  add  pre-flag(s)  for  loader 
-loader_postflag  -loadpstfs<arg> 

Explicitly  add  post-flag(s)  for  loader 
-iiiapa<arg>  Generate  a  link  map  file  (ICC  linker  only) 

-merge  Invoke  the  ICC  list  merger 

-mrg  Stop  at  the  generated  list  merge  file 

-ob|  Stop  at  the  generated  object  file  (default] 

-objliba<arg>  Install  the  object  file  in  library  <arg> 

-ob]lib  flag  -objlibfa<arg>  Explicitly  add  flag(s)  for  object  librarian 
-objlib~name  -objlibn><arg>  Use  <arg>  as  the  object  librarian 
-ont  Stop  at  the  optimizer  iform  file 

-optimize  -opt  Invoke  the  Ada  optimizer 

-preloader«<arg>  Execute  <arg>  before  linking 

-preloeder_f lag  -preloadf«<arg> 

Explicitly  add  flag(s)  for  preloader 
-postloader«<arg>  Execute  <arg>  after  linking 

-postloader_f lag  -pstloedf><arg> 

^  ExDlfcitly  sdd  flMCs)  for  oostloodor 

-ranlib  name  -ranlibn><arg>  Use  <srg>  as  the  ranlib  library  processor 
-release><arg>  Set  the  release  directory 

-show_only  Display  all  actions  to  be  performed 

-systeom<arg>  Set  the  s)rstam  library  directory 

-tool  version«<arg>  Specify  the  ICC  toolset  version 


- tool.versi on«<arg> 


Specify  the  ICC  toolset  version 


Ada  Qualifiers 

-information  Enable  informational  warnings  [default] 

-checks  Enable  all  runtime  checks  [default] 

-compatible  calls  Generate  calls  coepatible  with  C  calls 

-cross  reference  -xref  Generate  cross-reference  file  (.xrf) 
-declarea<arg>  Declare  an  identifier 

-debugger  Compile  for  the  Ada  symbolic  debugger 

-elaboration  check  -elab  check 


-exception  info 

-information 

-listing 

-maximum  errors><arg> 

-preprocess 

-rate 

-stack  check 
-syntax  only 
-trim  " 

-warnings  -w 

-wrap 

-zero 


Generate  ELABORATION  checking 
Enable  extra  EXCEPTION  information  [default] 
Enable  informational  warnings  [default] 
Generate  list  file  (.1st) 

Set  maximua  niadwr  of  errors  reported 
Generate  coanented  preprocess  file  (.app) 
Rate  co^  efficiency 
Generate  stack  checicing  code 
Syntax  check  only 

Generate  trisned  preprocess  file  (.app) 
Enable  warnings 

Enable  auto-wrapping  error  messages  [default] 
Zero  all  records  [default] 


Apr  7  22:37  1991  h^SO.doc/eoApf  lt_and_llnk_optiom.aU  Pape  2 


ICC  Coda  Clanarator  Quallffara 

'branch  ralativo  Uao  ralativa  branchaa  (ISO  ont^ 

-conat  Tn  coda  Place  constant  aggreiates  In  COOS  aegnant 

'hostefibugger  *cdb  -xdbGenarate  host  danigger  infonaatlon 


•extandad  (iating  *exl 
'fpa 

*  leaf  jprocadurea 
-gprofi le 
•loc  info 

•fpu~'n68881  •■68882 

•frane  size 


•nuaarlc  chack  'nuachk 

•probe  sTack 

•profile 

•real 

•static 


Generate  extended  code  Hating  output 
Generate  Inline  hardware  FPA  code  (MPUX  only) 
Generate  LEAF  procs  whan  possible  (180960  only) 
Generate  runtlae  'gprof  profiling 
Generate  extended  local  Infonaatlon 
Generate  Inline  hardware  floating*polnt  code 
Generate  fraae  size  for  each  s:^  (180960  only) 
Generate  naawllst  file  (.n) 

Generate  overflow  detection  code 
Generate  stack  probes 
Generate  runtlne  profiling 
Use  real  naaas 

Static  aode  (C  code  generator  only) 


ICC  Prelinker  Qualifiers 
•coapllnk  •cl><arg> 
•f^e  link 
•heap  ilzeB<arg> 
•llnk”'l»<arg> 

•output  •0B<arg> 

•stack  size  •stackB<arg> 


Ada  coaDila  and  link  <arg>  Into  one  file 
Force  link,  even  If  dependency  errors 
Allocate  <arg>  bytes  of  heap  (180960  only) 

Ada  link  conpilation  unit  <arg> 

Use  <arg>  as  the  executable  file  nane 
Allocate  <arg>  bytes  of  user  stack  (180960  only) 
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The  only  allowed  implementation  dependencies  correspond  to 
implementation-dependent  pragmas,  to  certain  machine-dependent  conventions 
as  mentioned  in  Chapter  13  of  the  Ada  Standard,  and  to  certain  allowed 
restrictions  on  representation  clauses.  The  implementation-depenc 3nt 
characteristics  of  this  Ada  implementation,  as  described  in  this  Appendix, 
are  provided  by  the  customer.  Unless  specifically  noted  otherwise, 
references  in  this  Appendix  are  to  compiler  documentation  and  not  to  this 
report.  Implementation-specific  portions  of  the  package  STANDARD,  which 
are  not  a  part  of  Appendix  F,  are: 


package  STANDARD  is 

type  INTEGER  is  range  -2147483648  ..  2147483647; 
type  FLOAT  is  digits  15 

range  -1 . 12355820928895E+307  ..  -1.12355820928895E+307; 

type  DURATION  is  delta  2.0**(-12) 
range  -524287.0  ..  524287.0; 

type  SH0RT_INTEGER  is  range  -32768  ..  32767; 

type  TINY_INTEGER  is  range  -128  ..127; 


end  STANDARD; 
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Appendix  F 
ICC  Ada  Version  7.0 
Hewlett-Packard,  Model  9000/350 
HP-UX,  Release  7.0 

Irvine  Compiler  Corporation 
34  Executive  Park,  Suite  270 
Irvine,  CA  92714 
(714)  250-1366 

April  23,  1991 

1  ICC  Ada  Implementation 

The  Ada  language  definition  leaves  implementation  of  certain  features  to 
the  language  implementor.  This  appendix  describes  the  implementation- 
dependent  characteristics  of  ICC  Ada. 

2  Pragmas 

The  following  predefined  pragmas  are  implemented  in  ICC  Ada  as  described 
by  the  Ada  Reference  Manual: 

Elaborate  This  pragma  allows  the  user  to  modify  the  elaboration  order  of 
compilation  units. 

Inline  Subprogram  inlining  is  implemented.  Inline  substitutions  are  per¬ 
formed  by  the  ICC  optimizer.  This  pragma  is  not  supported  for  generic 
subprograms  or  subprograms  which  contain  nested  subprograms. 

List  This  pragma  enables  or  disables  writing  to  the  output  list  file. 

Pack  Packing  on  arrays  and  records  is  implemented  to  the  bit  level.  Slices 
of  packed  arrays  are  not  implemented,  except  boolean  arrays. 
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Page  This  pragma  ejects  a  new  page  in  the  output  list  file  (if  enabled). 

Priority  This  pragma  sets  the  priority  of  a  task  or  main  program.  The 
range  of  the  subtype  priority  is  0..255. 

The  following  predefined  pragmas  have  been  extended  by  ICC: 

Interface  This  pragma  is  allowed  to  designate  variables  in  addition  to  sub¬ 
programs.  It  is  also  allowed  to  have  an  optional  third  parameter  which 
is  a  string  designating  the  name  for  the  linker  to  use  to  reference  the 
variable  or  subprogram.  The  third  parameter  has  the  same  effect  as 
pragma  Interface,  name. 

Suppress  In  addition  to  suppressing  the  standard  checks,  ICC  also  permits 
suppressing  the  following: 

Exception-  info  Suppressing  Exception-  info  improves  run-time  per¬ 
formance  by  reducing  the  amount  of  information  maintained  for 
messages  that  appear  when  exceptions  are  propagated  out  of  the 
main  program  or  any  task. 

All- checks  Suppressing  All.  checks  suppresses  all  the  standard 
checks  as  well  as  Exception,  info. 

The  following  predefined  pragmas  are  currently  not  implemented  by  ICC: 

Controlled  Memory. size  Optimize 
Shared  Storage,  unit  System,  name 

The  following  additional  pragmas  have  been  defined  by  ICC:  (For  further 
details  on  these  pragmas  refer  to  the  ICC  Ada  User’s  Reference  Guide.) 

Compress  This  pragma  reduces  the  storage  required  for  discrete  subtypes 
in  structures  (arrays  and  records).  Its  single  argument  is  the  name 
of  a  discrete  subtype.  It  specifies  that  the  subtype  should  be  repre¬ 
sented  as  compactly  as  possible  (regardless  of  the  representation  of  the 
subtype’s  base  type)  when  the  subtype  is  used  in  a  structured  type. 
The  storage  requirement  for  variables  and  parameters  is  not  affected. 
Pragma  Compress  must  appear  prior  to  any  reference  to  the  named 
subtype. 
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Export  This  pragma  is  a  complement  to  the  predefined  pragma  Inter¬ 
face.  It  enables  subprograms  written  in  Ada  to  be  called  from  other 
languages.  It  takes  2  or  3  arguments.  The  first  is  the  language  to  be 
called  from,  the  second  is  the  subprogram  name,  and  the  third  is  an 
optional  string  designating  the  actual  subprogram  name  to  be  used 
by  the  linker.  Pragma  Export  must  appear  prior  to  the  body  of  the 
designated  subprogram. 

External- name  This  pragma  is  equivalent  to  the  ICC  pragma  Export 
with  an  implicit  language  type  of  "Ada”  and  a  required  external  name. 
This  pragma  allows  the  user  to  specify  the  exact  name  of  the  subpro¬ 
gram  that  will  be  used  in  the  generated  object  file.  This  pragma  is 
provided  for  compatibility  with  existing  Ada  source  files. 

Foreign  This  pragma  is  used  to  add  an  object  file  or  an  object  library  file 
to  the  link  command  line  used  when  linking  the  current  compilation 
unit.  Pragma  Foreign  is  most  frequently  used  in  conjunction  with 
pragma  Interface  so  that  foreign  object  files  may  be  automatically 
included  when  the  Ada  compilation  unit  is  linked.  This  pragma  ac¬ 
cepts  two  parameters.  The  first  parameter  indicates  the  location  of 
the  foreign  object  name  on  the  link  command  line.  It  must  be  either 
Normal  or  Post.  The  second  parameter  is  a  string  denoting  the  foreign 
object.  This  string  is  passed  unmodified  to  the  linker,  so  it  should  be 
a  complete  filename.  If  the  location  is  Normal,  then  the  foreign  object 
is  included  immediately  after  the  current  Ada  compilation  unit  on  the 
link  command  line.  If  the  location  is  Post,  then  the  foreign  object 
name  is  included  at  the  end  of  the  link  command  line.  When  multiple 
Foreign  Post  pragmas  are  used  in  a  single  program,  the  order  of  the 
foreign  objects  on  the  link  command  line  is  not  defined. 

Interface- Name  This  pragma  takes  a  variable  or  subprogram  name  and 
a  string  to  be  used  by  the  linker  to  reference  the  variable  or  subpro 
graun.  It  has  the  same  effect  as  the  optional  third  parameter  to  pragma 
Interface. 

No-zero  The  single  parameter  to  No-zero  is  the  name  of  a  record  type. 
If  the  named  record  type  has  holes  (or  gaps)  between  fields  that  are 
normally  initialized  with  zeroes,  this  pragma  will  suppress  the  clearing 
of  the  holes.  If  the  named  record  type  has  no  holes  this  pragma  has 
no  effect.  When  zeroing  is  disabled,  comparisons  (equality  and  non- 
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equality)  of  the  named  type  are  disallowed.  The  use  of  this  pragma 
can  significantly  reduce  initialization  time  for  record  objects.  The 
ICC  Command  Interpreter  also  has  the  qualifier  NO- ZERO  which  has 
the  effect  of  implicitly  applying  pragma  No.  zero  to  all  record  types 
declared  in  the  file. 

Put,  Put- line  These  pragmas  take  any  number  of  arguments  and  write 
their  value  to  standard  output  at  compile  time  when  encountered 
by  the  compiler.  The  arguments  may  be  expressions  of  any  string, 
enumeration,  or  integer  type,  whose  value  is  known  at  compile  time. 
Pragma  Put.  line  adds  a  carriage  return  after  printing  all  of  its  argu¬ 
ments.  These  pragmas  are  often  useful  in  conjunction  with  conditional 
compilation.  They  may  appear  anywhere  a  pragma  is  allowed. 

Static- elaboration  This  pragma  is  used  immediately  within  a  package 
specification  to  state  that  all  elaboration  for  the  package  is  intended 
to  be  static.  A  warning  will  be  generated  for  all  objects  within  the 
package  specification  or  corresponding  body  which  require  dynamic 
elaboration. 

Unsigned- Literal  This  pragma,  when  applied  to  a  32-bit  signed  integer 
type,  affects  the  interpretation  of  literals  for  the  type.  Literals  be¬ 
tween  2**31  and  2**32  are  accepted  for  the  type  and  are  represented 
as  if  the  type  were  unsigned.  Operations  on  the  type  are  unaffected. 
Note  that  (with  checking  suppressed),  signed  addition,  subtraction, 
and  multiplication  are  equivalent  to  the  corresponding  unsigned  op¬ 
erations.  However,  division  and  relational  operators  are  different  and 
should  be  used  with  caution.  This  pragma  is  used  for  type  Address 
in  package  System. 

Uselib  This  pragma  is  used  within  a  context  clause  to  explicitly  add  a  list 
of  named  searched  libraries  to  the  library  search  list  of  the  current 
compilation.  The  specified  libraries  are  searched  first  in  all  following 
WITH  clauses. 


3  Preprocessor  Directives 

ICC  Ada  incorporates  an  integrated  preprocessor  whose  directives  begin 
with  the  keyword  Pragma.  They  are  as  follows: 
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Abort  This  pragma  causes  the  current  compilation  to  be  immediately 
halted.  It  is  useful  when  unexpected  circumstances  arise  inside  condi¬ 
tionally  compiled  code. 

If,  Elsif,  Else,  End  These  preprocessor  directives  provide  a  conditional 
compilation  mechanism.  The  directives  If  and  Elsif  take  a  boolean 
static  expression  as  their  single  argument.  If  the  expression  evaluates 
to  False  then  all  text  up  to  the  next  End,  Elsif  or  Else  directive  is 
ignored.  Otherwise,  the  text  is  compiled  normally.  The  usage  of  these 
directives  is  identical  to  that  of  the  similar  Ada  constructs.  These  di¬ 
rectives  may  appear  anywhere  pragmas  are  allowed  and  can  be  nested 
to  any  depth. 

Include  This  preprocessor  directive  provides  a  compile-time  source  file  in¬ 
clusion  mechanism.  It  is  integrated  with  the  library  management  sys¬ 
tem,  and  the  automatic  recompilation  facilities. 

The  results  of  the  preprocessor  pass,  with  the  preprocessor  directives 
deleted  and  the  appropriate  source  code  included,  may  be  output  to  a  file  at 
compile- time.  The  preprocessor  may  be  disabled  by  using  the  NOPREPROCESS 
command-line  qualifier,  in  which  case  the  above  directives  are  ignored. 


4  Attributes 

ICC  Ada  implements  all  of  the  predefined  attributes,  including  the  Repre¬ 
sentation  Attributes  described  in  section  13.7  of  the  Ada  RM. 

Limitations  of  the  predefined  attributes  are: 

Address  This  attribute  cannot  be  used  with  a  statement  label  or  a  task 
entry. 

The  implementation  defined  attributes  for  ICC  Ada  are: 

Version,  System,  Target,  CG.mode  These  attributes  are  used  by  ICC 
for  conditional  compilation.  The  prefix  must  be  a  discrete  type.  The 
values  returned  vary  depending  on  the  target  architecture  and  oper¬ 
ating  system. 
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5  Input/Output  Facilities 


5.1 

The  implementation  dependent  specifications  from  TEXT- 10  and  DI¬ 
RECT- 10  are: 

type  COUIT  is  rang#  0  ..  IITEGER’LAST; 

snbtyps  FIELD  is  IITEGER  range  0  ..  IITEGER'UST; 

5.2  FORM  Parameter 

ICC  Ada  implements  the  FORM  parameter  to  the  procedures  OPEN  and 
CREATE  in  DIRECT.IO,  SEQUENTIAL- 10,  and  TEXT.IO  to  perform 
a  variety  of  ancillary  functions.  The  FORM  parameter  is  a  string  literal 
containing  parameters  in  the  style  of  named  parameter  notation.  In  general 
the  FORM  parameter  has  the  following  format: 


=>  valuei  [,  fieldn  =>  valucn  ]” 


where  fieldi  =>  valuei  can  be 


OPTION  => 

OPTION  => 

PAGE-MARKERS  => 
PAGE-MARKERS  => 
READ-INCOMPLETE  => 
READ-INCOMPLETE  => 
MASK  => 


NORMAL 

APPEND 

TRUE 

FALSE 

TRUE 

FALSE 

<9  character  protection  mask> 


Each  field  is  separated  from  its  value  with  a  “=>”  and  each  field /value 
pair  is  separated  by  a  comma.  Spaces  may  be  added  anywhere  between 
tokens  and  upper-case/lower-case  is  insignificant.  For  example: 

crsatsC  f,  out.lils,  "list. data”, 

"option  =>  append,  PAGE.NARXERS  =>  FALSE,  Mask  =>  rvxrvz - ") 

The  interpretation  of  the  fields  and  their  values  is  presented  below. 


OPTION  Files  may  be  opened  for  appendage.  This  causes  data  to  be 
appended  directly  onto  the  end  of  an  existing  file.  The  default  is 
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NORMAL  which  overwrites  existing  data.  This  held  applies  to  OPEN  in 
all  three  standard  I/O  packages.  It  has  no  effect  if  applied  to  procedure 
CREATE. 

PAGE- MARKERS  If  FALSE  then  all  TEXT.  10  routines  dealing  with  page 
terminators  are  disabled.  They  can  be  called,  however  they  will  not 
have  any  effect.  In  addition  the  page  terminator  character  (“L)  is  al¬ 
lowed  to  be  read  with  GET  and  GET-LINE.  The  default  is  TRUE  which 
leaves  page  terminators  active.  Disabling  page  terminators  is  particu¬ 
larly  useful  when  using  TEXT- 10  with  an  interactive  device.  For  out¬ 
put  hies,  disabling  page  terminators  will  suppress  the  page  terminator 
character  that  is  normally  written  at  the  end  of  the  hie. 

READ- INCOMPLETE  This  held  applies  only  to  DIRECT-IO  and  SEQUENTIAL.IO 
and  dictates  what  will  be  done  with  reads  of  incomplete  records.  Nor¬ 
mally,  if  a  READ  is  attempted  and  there  is  not  enough  data  in  the  hie 
for  a  complete  record,  then  END-ERROR  or  DATA-ERROR  will  be  raised. 

By  setting  READ- INCOMPLETE  to  TRUE,  an  incomplete  record  will  be 
read  successfully  and  the  remaining  bytes  in  the  record  will  be  ze¬ 
roed.  Attempting  a  read  after  the  last  incomplete  record  will  raise 
END- ERROR.  The  SIZE  function  will  rehect  the  fact  that  there  is  one 
more  record  when  the  last  record  is  incomplete  and  READ- INCOMPLETE 
is  TRUE. 

MASK  Set  a  protection  mask  to  control  access  to  a  hie.  The  mask  is  a 
standard  nine  character  string  notation  used  by  Unix.  The  letters 
cannot  be  rearranged  or  deleted  so  that  the  string  is  always  exactly 
nine  characters  long.  This  applies  to  CREATE  in  all  three  standard 
I/O  packages.  The  default  is  determined  at  runtime  by  the  user’s 
environment  settings. 

The  letters  in  the  Mask  are  used  to  dehne  the  Read,  Write  and 
execute  permissions  for  the  User,  Group  and  World  respectively.  Wher¬ 
ever  the  appropriate  letter  exists,  the  corresponding  privilege  is  granted. 

If  a  is  used  instead,  then  that  privilege  is  denied.  For  example  if 

Mask  were  set  to  "rw-rw - ”  then  reawl  and  write  privilege  is  granted 

to  the  hie  owner  and  his/her  group,  but  no  world  rights  are  given. 


If  a  syntax  error  is  encountered  within  the  FORM  parameter  then  the 
exception  USE- ERROR  is  raised  at  the  OPEN  or  CREATE  call.  Also,  the  stan- 
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dard  function  TEXT- 10. FORM  returns  the  current  setting  of  the  form  fields, 
including  default  values,  as  a  single  string. 

6  Package  SYSTEM 

Package  SYSTEM  is  defined  as: 

package  SYSTEM  is 

type  lANE  is  (N68000); 

—  Language  Defined  Constants 

SYSTEM.IINE  :  constant  lANE  ;=  M68000; 

STORAGE.UIIT  :  constant  8; 

MEMORY.SIZE  :  constant  :=  16*(2**20): 

MII_1IT  :  constant  :=  -2**31; 

M1X_IIT  :  constant  :=  2**31-1; 

NiX_0IGITS  :  constant  15; 

NAX.MAITISSA  :  constant  :=  31; 

FIIE_DELTA  :  constant  :«  2.0**(-31); 

TICK  :  constant  :=  1.0/60.0; 

type  ADDRESS  is  rang*  MII.IIT  ..  MAX.IIT;  —  Signed  32  bit  range. 

subtype  PRIORITY  is  IITEGER  rang*  0  ..  255;  --  0  is  default  priority. 

"  Constants  for  the  STIHEAP  packeige 

BITS.PER.BNU  :  constant  8; 

NAX_ALZGIIIEIT  ;  constant  :*  4; 

NII.NEN.BLOCK  :  constant  :*  1024; 

—  Constants  for  the  HOST  package 

HOST_CLOCK_RESOLOTIOI  :  constant  :=  1;  --1  Microsecond. 

BASE_DATE_CORRECTIOI  :  constant  ;=  25_202;  —  Unix  base  date  is  1/1/1970. 

pragma  OISIGIED.LITERAL  (ADDRESS);  —  Allou  unsigned  literals. 

lULL.ADDRESS  :  constant  ADDRESS  0;  —  Value  of  type  ADDRESS 

—  equal  to  HULL. 

pragma  PUT_LIIE  ("Target:  ",  SYSTEM.IAME) ; 


—  Bits  per  basic  machine  unit 

—  Maximum  alignment  required. 

—  Minimum  chunk  request  size. 
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•nd  SYSTEM; 


7  Limits 

Most  data  structures  held  within  the  ICC  Ada  compiler  are  dynamically 
allocated,  and  hence  have  no  inherent  limit  (other  than  available  memory). 
Some  limitations  are: 

The  maximum  input  line  length  is  254  characters. 

The  maximum  number  of  tasks  abortable  by  a  single  abort  statement  is 
64. 

Include  files  can  be  nested  to  a  depth  of  3. 

The  number  of  packages,  subprograms,  tasks,  variables,  aggregates,  types 
or  labels  which  can  appear  in  a  compilation  unit  is  unlimited. 

The  number  of  compilation  units  which  can  appear  in  one  file  is  unlimited. 

The  number  of  statements  per  subprogram  or  block  is  unlimited. 

Packages,  tasks,  subprograms  and  blocks  can  be  nested  to  any  depth. 

There  is  no  maximum  number  of  compilation  units  per  library,  nor  any 
maximum  number  of  libraries  per  library  system. 

8  Numeric  Types 

ICC  Ada  supports  three  predefined  integer  types: 

TINY.  INTEGER  -128..127  sTitT 

SHORT-INTEGER  -32768..32767  16  bits 

INTEGER _ •2147483648..2147483647  32  bits 

In  addition,  unsigned  8-bit,  16-bit  and  32-bit  integer  types  can  be  defined 
by  the  user  via  the  SIZE  length  clause.  Storage  requirements  for  types  can 
be  reduced  by  using  pragma  Pack  and  record  representation  clauses  and  for 
subtypes  by  using  the  ICC  pragma  Compress. 

Type  float  is  available. 
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Attribute 

FLOAT  value 

size 

64  bits 

digits 

15 

first 

-1.12355820928895f;  -I-  307 

last 

-I-1.12355820928895E  -I-  307 

Fixed  point  types  automatically  assume  the  smallest  storage  size  necessary 
to  represent  all  of  the  model  numbers  with  the  indicated  delta  and  range. 
The  size  of  a  fixed  point  type  may  be  changed  via  the  SMALL  representation 
clause  and  the  SIZE  length  clause.  Unsigned  fixed  point  types  may  be 
defined  using  the  SIZE  length  clause. 

ICC  Ada  rounds  real  (fixed  and  floating  point)  values  away  from  zero  at 
the  mid- point  between  integral  values  (i.e.  1.5  rounds  to  2.0  and  -3.5  rounds 
to  -4.0). 


9  Tasks 


The  type  DURATION  is  define< 

Attribute 

i  with  the  following  characteristics: 

DURATION  value 

delta 

small 

2.44140625E  -  04  sec 

2.44140625F  -  04  sec 

first 

last 

The  subtype  SYSTEM.PRIORI 

Attribute 

-524287.0  sec 

524287.0  sec 

TY  as  defined  provides  the  following  range: 

PRIORITY  value 

first 

last 

Higher  numbers  correspond  to  ! 
for  a  task,  PRIORITY’FIRST  it 

0 

255 

higher  priorities.  If  no  priority  is  specified 
;  assigned  during  task  creation. 

10  Representation  Clauses 

10.1  Type  Representation  Clauses 

10.1.1  Length  Clauses 

The  amount  of  storage  to  be  associated  with  an  entity  is  specified  by  means 
of  a  length  clause.  The  following  is  a  list  of  length  clauses  and  their  imple- 
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mentation  status: 

•  The  SIZE  length  clause  is  implemented.  When  applied  to  integer  range 
types  this  length  clause  can  be  used  to  reduce  storage  requirements 
including  storage  as  unsigned  values.  It  may  be  used  to  declare  an 
unsigned  32-bit  type.  Length  clauses  are  allowed  for  float  and  flxed 
point  types,  however  the  storage  requirements  for  these  types  cannot 
be  reduced  below  the  smallest  applicable  predeflned  type  available. 

•  The  STORAGE.SIZE  length  clause  for  task  types  is  implemented. 
The  size  specified  is  used  to  allocate  both  the  task’s  Task  Information 
Block  (TIB)  and  its  stack. 

•  The  STORAGE-SIZE  length  clause  for  access  types  is  implemented. 
When  a  length  clause  is  encountered  for  an  access  type,  a  block  of 
memory  is  reserved  in  the  user’s  heap  space.  This  block  of  memory 
cannot  be  expanded  beyond  the  bounds  specified  in  the  length  clause. 
When  the  memory  in  this  block  is  exhausted,  STORAGE-ERROR  is  raised. 
Due  to  heap  management  overhead,  the  full  amount  of  memory  indi¬ 
cated  in  the  length  clause  may  not  be  available  for  allocation. 

•  The  SMALL  length  clause  for  fixed  point  types  is  implemented  for 
powers  of  two.  ICC  Ada  does  not  support  SMALL  values  that  are  not 
integral  powers  of  two. 

10.1.2  Enumeration  Representation  Clauses 

Enumeration  representation  clauses  are  implemented.  The  use  of  enumera¬ 
tion  representation  clauses  can  greatly  increase  the  overhead  associated  with 
their  reference.  In  particular,  FOR  loops  on  such  enumerations  are  very  ex¬ 
pensive.  Representation  clauses  which  define  the  default  representation  (i.e. 
The  first  element  is  .ordinal  0,  the  second  1,  the  third  2,  etc.)  are  detected 
and  cause  no  additional  overhead. 

10.1.3  Record  Representation  Clauses 

Record  representation  clauses  are  implemented  to  the  bit-level.  Records  con¬ 
taining  discriminants  and  dynamic  arrays  may  not  be  organized  as  expected 
because  of  unexpected  changes  of  representation.  There  are  no  implemen¬ 
tation  generated  names  that  can  be  used  in  record  representation  clauses. 
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Record  representation  clauses  allow  more  precise  packing  than  pragma 
Pack.  Record  representation  clauses  allow  the  user  to  specify  the  exact 
location  of  fields  within  a  record  to  the  bit-level.  The  ICC  Ada  compiler 
implements  bit-level  record  representation  clauses  including  nested  records 
starting  on  bit-boundaries.  Since  the  user  specifies  the  exact  bit  location, 
overhead  for  extracts  and  stores  may  be  very  high,  so  record  representation 
clauses  should  be  applied  very  carefully.  Record  representation  clauses  are 
implemented  using  the  following  rules: 

•  Fields  of  records  may  be  allocated  to  the  nearest  bit  for  elements  which 
are  smaller  than  32-bits.  This  includes  small  nested  records.  Elements 
32-bits  or  larger  (and  all  arrays)  must  be  placed  on  byte  boundaries. 

•  If  the  specified  storage  space  for  an  element  is  not  adequate  using  its 
default  allocation,  it  will  automatically  be  packed  in  two  stages:  (1) 
Normal  packing  will  be  attempted  using  the  default  alignment  rules.  If 
this  does  not  adequately  reduce  storage  then  (2)  bit-level  packing  will 
be  attempted  with  all  fields  aligned  on  8-blt  or  smaller  boundaries.  If 
this  bit-level  packing  still  does  not  meet  the  storage  requirement,  an 
error  message  wiU  be  generated. 

•  The  optional  alignment  clause  may  be  used  to  specify  an  alignment 
up  to  8  bytes. 

•  All  fields  of  a  record  representation  clause  which  are  left  unspecified 
will  be  allocated  at  the  end  of  the  record  using  the  default  alignment 
rules  for  each  element. 

•  The  fields  of  a  record  representation  clause  may  be  specified  in  any 
order  and  the  storage  order  of  the  fields  does  not  need  to  be  the  same 
as  the  order  in  which  they  were  declared. 

•  If  no  alignment  clause  is  specified,  the  alignment  requirement  for  the 
record  is  equivalent  to  the  largest  alignment  requirement  of  its  ele¬ 
ments. 

10.2  Address  Clauses 

Address  clauses  are  implemented  for  variables.  Address  clauses  for  local 
variables  using  dynamic  values  are  implemented.  The  use  of  a  dynamic  ad¬ 
dress  can  facilitate  overlaying  since  the  address  specified  may  be  the  value  of 
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a  variable  of  type  Systam.  Address  or  may  be  the  result  of  an  expression  us¬ 
ing  the  predefined  Address  attribute.  Address  clauses  are  not  implemented 
for  subprograms,  packages,  tasks,  constant  objects,  or  statement  labels. 

11  Interface  to  Other  Languages 

Pragma  Interfisce  allows  Ada  programs  to  interface  with  (i.e.,  call)  subpro¬ 
grams  written  in  another  language  (e.g.,  assembly,  C),  and  pragma  Export 
allows  programs  written  in  another  langus^e  to  interface  with  programs  writ¬ 
ten  in  Ada.  The  accepted  languages  are:  Intrinsic,  Ada,  C  and  Assembly. 
The  aliases  Assembler  and  ASM  can  also  be  used  instead  of  Assembly.  The 
language  Intrinsic  should  be  used  with  care — it  is  used  by  ICC  for  inter¬ 
nally  handled  operators. 

12  Unchecked  Type  Conversion 

The  generic  function  Unchecked. conversion  is  implemented.  In  general, 
unchecked-conversion  can  be  used  when  the  underlying  representations  of 
values  are  similar. 

Acceptable  conversions  are: 

•  Conversion  of  scalars.  Unchecked-conversion  can  be  used  to  change 
the  type  of  scalar  values  without  restriction.  In  most  circumstances 
the  unchecked  conversion  produces  no  additional  code. 

•  Conversion  of  static  constrauned  structures.  Constrained  static  arrays 
and  records  are  represented  as  contiguous  areas  of  memory,  and  hence 
can  be  converted  using  unchecked-conversion. 

•  Conversion  of  scalars  to  static  constrained  structures.  Scalar  objects 
may  be  converted  to  static  constrained  structures  with  no  additional 
overhead.  If  a  scalar  value  is  converted  to  a  structure,  an  aggregate 
is  first  built  to  hold  the  scalar  value  and  its  address  is  used  as  the 
address  of  the  resulting  structure. 

Because  the  representation  of  dynamic  structures  uses  implicit  pointers  and 
dope-vectors,  ICC  Ada  does  not  allow  unchecked  conversions  to  or  from 
dynamic  or  unconstrained  structures  (arrays  or  records).  A  compile-time 
error  message  will  be  generated  for  such  instantiations. 
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Although  the  Ada  compiler  does  not  produce  errors  for  the  following 
unchecked  conversions,  they  should  be  avoided  since  their  results  are  not 
obvious: 

•  Conversion  from  constrained  discriminant  records.  Conversion  from 
discriminant  records  can  cause  unpredictable  behavior  because  of  un¬ 
derlying  representation  changes.  The  unchecked-conversion  will  use 
the  same  rules  as  described  above  for  performing  the  copy,  however 
the  results  of  this  operation  may  not  be  what  the  user  desires,  since 
ICC  Ada  does  not  place  arrays  constrained  by  the  discriminant  in-line 
with  the  other  fields  in  a  discriminant  record.  In  place  of  the  array 
only  a  pointer  is  used  and  the  array  is  allocated  dynamically  from  the 
internally  maintained  heap. 

•  Conversion  to  or  from  pointers  to  unconstrained  arrays.  Unconstrained 
array  pointers  are  implemented  as  special  dope-vectors  in  ICC  Ada. 
Conversions  to  or  from  these  dope- vectors  are  not  recommended. 

•  Conversion  to  or  from  any  type  or  object  declared  in  a  generic.  Gener¬ 
ics  can  cause  hidden  representation  changes.  Unchecked.conversions 
of  any  object  or  type  declared  in  a  generic  should  be  avoided. 

ICC  Ada  does  not  require  that  the  sizes  of  the  parameters  to  an 
unchecked. conversion  be  identical.  The  size  of  the  target  type  is  used  to 
determine  the  number  of  bytes  to  copy.  The  size  of  the  target  type  (in 
bytes)  is  determined  by  the  Ada  front  end  and  exactly  that  many  bytes  are 
copied  from  the  source  address  to  the  target  auldress.  This  can  cause  prob¬ 
lems  (e.g.  memory  faults)  when  the  source  object  is  smaller  than  the  target 
object.  For  example,  using  unchecked.conversion  to  convert  a  character  into 
an  integer  will  cause  4  bytes  to  be  copied  starting  from  the  address  of  the 
character.  The  first  byte  copied  will  be  the  value  of  the  character,  but  the 
values  of  the  remaining  three  bytes  cannot  be  predicted  since  they  depend 
on  values  of  variables  or  fields  immediately  after  the  character  in  memory. 
If  the  source  object  is  larger  than  the  target  object  then  only  the  bytes  that 
will  fit  in  the  target  object  are  copied  from  the  source  starting  at  the  address 
of  the  first  byte  of  the  source. 


13  Unchecked  Storage  Deallocation 

Unchecked- deallocation  is  implemented.  Unchecked. deallocation  of 


15 


structures  containiug  dynamic  elements  (such  as  discriminant  records  with 
dynamic  arrays)  should  not  be  performed  since  these  nested  structures  are 
not  automatically  deallocated. 

14  Main  Programs 

Main  programs  may  be  procedures  or  functions  and  may  have  any  number 
of  parameters.  Parameter  and  function  return  types  can  be  either  discrete 
types  (including  enumerations)  or  unconstrained  arrays.  Parameters  may 
also  include  default  values.  If  the  main  program  is  a  function,  then  upon 
exit  the  returned  value  will  be  printed  on  the  user’s  screen.  If  the  program 
is  invoked  with  the  wrong  number  of  parameters  a  usage  error  message  is 
printed  and  execution  is  aborted.  If  an  illegal  value  is  passed  to  a  parameter 
then  CONSTRAINT.ERROR  is  raised. 


